home *** CD-ROM | disk | FTP | other *** search
/ ShareWare OnLine 2 / ShareWare OnLine Volume 2 (CMS Software)(1993).iso / comm2 / xrcfg104.zip / XRCONFIG.DOC < prev    next >
Text File  |  1992-12-20  |  7KB  |  105 lines
  1.       ┌──────────────────────────────────────────────────────┐
  2.       │ X R C o n f i g  /  W i n X R C f g --- version 1.04 │
  3.       └──────────────────────────────────────────────────────┘
  4.  
  5. This versions should do everything it is supposed to do!  It reads your old
  6. CONFIG.XRS file (and find it on the "PATH" if necessary), and creates a new
  7. one in the current directory if none is found.  It replaces your old
  8. CONFIG.XRS with the new version if you select "OK" and discards your changes
  9. if you pick "Cancel" or reset the Defaults.  For now any item in your old
  10. CONFIG.XRS (if any) that is not "recognized" is just copied to the new file -
  11. that way any new options (or XCS/XAP/XUC/etc options XRS itself doesn't use)
  12. that XRConfig doesn't "know" are just preserved and not changed or eliminated.
  13. Note that comments on_parameter_lines that XRConfig *does* know are always
  14. removed when you save a new configuration file.  Also note that XRConfig saves
  15. any new CONFIG.XRS in mostly sorted format - except the parameters which
  16. aren't recognized (they 'float to the top').  One more thing - XRConfig makes
  17. parameters consistent: all path names are written out with a trailing slash
  18. (which are optional), and each parameter is written in NameCase per the
  19. example in "CONFIG.DMO" that comes with XRS.
  20.  
  21. There are several options that are not included in XRConfig: XRSColor (you
  22. must use the <ALT+F7> function hot-key inside XRS itself), Twiting, AutoTags
  23. and AutoMatches, Attribution Lines and Macros.  Some of these might be added
  24. later - for now, you will have to manually edit "CONFIG.XRS" to change them.
  25. Also, neither "EmptyBag x" nor "FirstDo x" are allowed, since XRConfig has
  26. no way of knowing which XRS native language you are using (and therefore it
  27. doesn't know if any 'x' you enter is allowable for that option or not).
  28.  
  29. Only <ALT_SPACE> e<X>it or <ALT_F4> or <TAB>ing to one of the exit buttons
  30. allows you to exit the program using only the keyboard.  Of course, with the
  31. mouse, everything is *much* simpler!  For a more complete explantion of
  32. navigating the screen without a mouse, see the "Keyboard Help" routine under
  33. the 'Help' menu-bar pull-down.
  34.  
  35. If you want to try XRConfig.Exe from inside XRS itself (which is supported
  36. under version 4.99 or later!), just put XRCONFIG.DAT and XRCONFIG.EXE on the
  37. PATH somewhere (it is no longer required to put 'XRCONFIG.DAT' persistant
  38. object in the subdirectory where you will be running the program!).  XRS will
  39. 'notice', and offer to call XRConfig from the <F4> hot-keyed configuration
  40. window (by hitting <F4> again).  XRS should handle the transition to and from
  41. graphics mode, including the mouse pointer!  Note that there is a bug in all
  42. versions prior to 5.02 (non-alpha) that doesn't reset the video mode correctly
  43. after XRS calls XRConfig if it is in an 8x8-character font other than CGA 25-
  44. line mode.  This is corrected in the 5.02 "Wide Beta" release or later.
  45.  
  46. To crank it up as a 'free-standing' configuration utility, just type XRCONFIG.
  47.  
  48. XRConfig is totally object-oriented.  (and is my first major undertaking in
  49. 100% object-oriented C++ instead of structure C programming)  This extends
  50. even to the 'function overloading' by entering them from the command-line!
  51. Currently, the only overload XRConfig recognizes is forcing a text display
  52. instead of the graphics interface (accomplished by typing "XRCONFIG +t").
  53. This overload may be especially useful for DesqView users on a '286 machine,
  54. where the virtualization of graphics is not supported (XRConfig is graphical
  55. even under DOS!).  Also, CGA users may prefer text mode, since the graphics
  56. is much too 'chunky', IMHO.  
  57.  
  58. This 1.04 release should fix the out-of-view buttons in HERC graphics mode!
  59. Also fixes default motion (sequence of <TAB> & <BackTAB> keys between groups).
  60.  
  61. Also, note that XRConfig has an atypical SAA/CUA interface: all three of the
  62. buttons along the bottom are exit functions - the first one, "OK" saves your
  63. changes, the second "Defaults" resets your existing CONFIG.XRS file to the
  64. original defaults provided in CONFIG.DMO with the 5.02 version of XRS, and
  65. the last one - "Cancel" discards your changes and exits (all three exit the
  66. program!).  You can exit the program with <ALT_F4> (under DOS or Windows)
  67. and XRS will prompt you whether or not to save the configuration file (the
  68. default being "Yes").
  69.  
  70. Beware, however (if you're not used to it) that XRConfig/WinXRCfg *does*
  71. follow CUA guidelines in the string editing windows: hitting a non-motion
  72. key blanks any existing data in the field.  To change existing data, always
  73. use an arrow key or other motion key first.  Hitting <ESC> during any field
  74. (any <P>ath, <B>uffers or <N>umbers pull-down menu items) will return the
  75. original value and quit the edit instead of saving your changes.  Using the
  76. Close pull-down or <ALT_F4> hotkey does *NOT* save changes!  Note that there
  77. is "pro-active" error-checking going on inside the method which accepts the
  78. numeric input (i.e. hitting a non-numeric printable character key will give
  79. you an immediate "Error Report" dialog box with a description of the error
  80. and only an "OK" option available - and the non-numeric key will be ignored.
  81. The range of each numeric parameter is checked when you complete entry with
  82. the <Enter> or <GrayEnter> key - and skipped is you <ESC>ape or <ALT_F4>
  83. (Close) the window instead (as well as discarding changes in both cases) -
  84. if the number you entered does not fall within a reasonable range, XRConfig
  85. will display an error message and reject your entry.  To delete any existing
  86. numeric parameter, set it to zero.  String fields are not checked during key
  87. entry, but each sub-directory or file that should exist is checked to see if
  88. it is really there - if not the entry is rejected.  Again - if you have a
  89. string-type parameter set, and want to delete it, simply blank out the
  90. existing string for the parameter - <BackSpace><Enter> should do it!
  91.  
  92. One important note: Windows programs I release will only run in standard or
  93. enhanced mode on a '286 or higher computer - they will not run on an 8086/8
  94. or V20/V30!  (XRConfig.Exe is a 'generic' DOS app which runs on any DOS-
  95. based computer in both text and graphics modes.)
  96.  
  97.  
  98. The "Defaults" (if you pick the 'Defaults' button) currently are:
  99.  
  100. <INS> <F9> Reversed        Always            Buffer 8192
  101. Help Palette            Hide Search        Internal Editor
  102. Jump Headers            Nuke Garbage        One Tear
  103. Pause 2                PreLoad Summary        Quote Header
  104. Swap                Thread only        To Name Prompt
  105.